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CLAIMS : 
1 . 



For a software application that uses a first 
interface related to a first piece of software code, a 
method of migrating the software application to allow the 
5 software application to use a second interface instead of 
the first interface, the method comprising: 

creating a computer -readable mapping between the 
first interface and the second interface; 



0 



running the mapping through an auto-generator, 
wherein the auto-generator uses the mapping to automatically 
generate an interface wrapper; 

replacing the first interface and the first piece 
of software code with the interface wrapper, thereby 
interposing the interface wrapper between the software 
application and the second interface; 

wherein the interface wrapper allows the software 
application to communicate with the second interface instead 
of the first interface. 

2. The method of claim 1, wherein the interface 

wrapper provides for at least one of (a) forward 
compatibility wherein the interface wrapper allows the 
software application to transparently communicate with the 
second interface and (b) backward compatibility wherein the 
interface wrapper allows the second interface to 
transparently communicate with the software application. 

3 - The method of claim 2, wherein for forward 

compatibility, creating the computer-readable mapping 
comprises creating a mapping from the first interface to the 
second interface. 
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4. The method of claim 2, wherein for backward 

compatibility, creating the computer-readable mapping 
comprises creating a mapping from the second interface to 
the first interface. 

5 5. The method of claim 1, wherein the auto-generator, 

in an object-oriented environment, is software comprising 
the following instructions: 

a) for each class in the first interface 

a. l) from all classes to be included in the interface 
10 wrapper mapped from the class in the first 

interface, select a master class to hold handles to 
all other classes in the interface wrapper mapped 
from the class in the first interface; 

b) for each class to be included in the interface wrapper as 
15 set out in the computer-readable mapping 

b. l) if the class to be included in the interface wrapper 

is the master class, initialize all the handles in 
the master class; 

b.2) for each attribute in the class to be included in 
2 0 the interface wrapper 

b.2.1) add code from the computer- readable mapping 
related to the attribute to the class to be 
included in the interface wrapper; 

b.3) for each method in the class to be included in the 
2 5 interface wrapper 



1563 7ROUS01U 



31 



b.3.1) add code from the computer- readable mapping 
related to the method to the class to be 
included in the interface wrapper. 

The method of claim 1, wherein the auto-generator, 
in an object-oriented environment, is software comprising 
the following instructions 

for each class to be included in the interface wrapper as 
set out m the computer-readable mapping: 

a) define the class to be included in the interface wrapper 

b) for each class from the first interface mapped to the 
class to be included in the interface wrapper as set out 
m the computer readable mapping: 

b.D if the class from the first interface is mapped only 
to the class to be included in the interface 
wrapper 

b.l.l) add a member for the class from the first 

interface to the class to be included in the 
interface wrapper; 

b.1.2) add construction of the member to all 

constructors in the class to be included in 
the interface wrapper; 

b.2) else if the class to be included in the interface 

wrapper is the first of all classes in the interface 
wrapper mapped from the class from the first 

interface as set out in the computer-readable 
mapping : 
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10 



b.2.1) designate the class to be included in the 

interface wrapper as a master class to hold 
handles to all other classes in the interface 
wrapper mapped from the class in the first 
interface; 

b.2.2) add a member for the class from the first 

interface to the class to be included in the 
interface wrapper; 

b.2.3) add construction of the member to all 

constructors in the class to be included in 
the interface wrapper; 

b.2.4) for each other class in the interface wrapper 
mapped from the class from the first 
interface 

b.2.4.1) add a member for the other class in 

the interface wrapper to the master 
class ; 

b.2.4. 2) add construction of the other class 

in the interface wrapper to all 

20 

constructors in the master class; 

b.2.4. 3) add a call to initialize the member 

wherein the member will know that 

the class to be included in the 

interface wrapper is the master 
25 , 

class in all constructors of the 

other class in the interface 
wrapper; 

b.2.4. 4) add a method to the other class in 

the interface wrapper to retrieve 



15 
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the member by a type name of the 
other class; 



b.3) else 



b. 3.1) add a member for the master class to the class 
to be included in the interface wrapper; 

b-3. 2) add a method to the class to be included in 
the interface wrapper to allow the member to 
be initialized to point to the master class; 

1Q b.3. 3) add a method to the class to be included in 

the interface wrapper to retrieve the member; 

c) for each attribute in the class i-« • * . 

cue ciass to be included in the 

interface wrapper 

c.l) add code from the computer-readable mapping related 
to the attribute to the class to be included in the 
interface wrapper; 

d) for each method in the claqo ^ k~ -> , 

cne class to be included in the 

interface wrapper 

d.l) add code from the computer-readable mapping related 

t0 the meth ° d to the d^s to be included in the 
interface wrapper. 

7- The method of claim 1, wherein the software 

application, the first interf 3 p P a ^ *-u 

interlace and the second interface 

are written in the Java language. 

8. Th e method of claim 1, wherein the computer- 

readable mapping is written in a language selected from one 
of XML and UML. 
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9. 



0 



The method of claim 1, wherein t-ho - 
•i ~ ^ wnerein the auto-gene rah or- 

is software written ^ , * aeneracor 
^ . bitten xn a f orm selected from one of XSL 

templates, bean script and XDoclet. 

5 aool' ^ ° f Claim lf WhSrein the software 

application is migrated from ^ ^ 

second interface without modifying the soft- 

j. tying the software application. 

A system adapted to assist with the migration of a 

^L^ tim from a first in — - 

mterface, the system comprising g proces 

computer-readable medium comprising auto-gene r at ion & 
e a W bT;' ^ ^ ^ — a eo mpute , 

ZTeTJT: 119 from the first interface to the ™ 

" P—-g pl atform be±ng 

instructions of the »,,►„ „ . execute 

°r the auto-generation software to process the 
-Ppin g to produce an interface wrapper wherein the 
interface wrapper aliows the software application to 
transparently communicate with the second interface. 

of the auto^ SYSCem " ° laim " herei " "» ^-tructions 

instruct!::;: ation so£twsre ™~ 

a) for each class in the first interface 

a.D fro. ali classes to he included in the interface 
wrapper mapped from the class in the first 
interface, select a master class to hold handles to 

from"! r 333 " ^ lnterflCe ™ 

from the class in the first interface; 

out xn the computer-readable mapping 
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b.l) if the class to be included in the interface wrapper 
is the master class, initialize all the handles in 
the master class; 

b.2) for each attribute in the class to be included in 
5 the interface wrapper 

b.2.1) add code from the computer-readable mapping 
related to the attribute to the class to be 
included in the interface wrapper; 

b.3) for each method in the class to be included in the 
10 interface wrapper 

b.3.1) add code from the computer-readable mapping 
related to the method to the class to be 
included in the interface wrapper. 

13. The system of claim 11 wherein the instructions 

15 from the auto-generation software comprises the following 
instructions : 

-for each class to be included in the interface wrapper as 
set out in the computer- readable mapping: 

a) define the class to be included in the interface wrapper 

20 b) for each class from the first interface mapped to the 

class to be included in the interface wrapper as set out 
in the computer readable mapping: 

b.l) if the class from the first interface is mapped only 
to the class to be included in the interface 
2 5 wrapper: 
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b.1.1) add a member for the class from the first 

interface to the class to be included in the 
interface wrapper; 

b.1.2) add construction of the member to all 
5 constructors in the class to be included in 

the interface wrapper; 

b.2) else if the class to be included in the interface 

wrapper is the first of all classes in the interface 
wrapper mapped from the class from the first 
10 interface as set out in the computer- readable 

mapping: 

b.2.1) designate the class to be included in the 

interface wrapper as a master class to hold 
handles to all other classes in the interface 
15 wrapper mapped from the class in the first 

interface; 

b.2. 2) add a member for the class from the first 

interface to the class to be included in the 
interface wrapper; 

2 0 b.2. 3) add construction of the member to all 

constructors in the class to be included in 
the interface wrapper; 

b.2. 4) for each other class in the interface wrapper 
mapped from the class from the first 
25 interface 



b.2. 4.1) add a member for the other class in 

the interface wrapper to the master 
class; 
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b. 2. 4. 2) add construction of the other class 

in the interface wrapper to all 
constructors in the master class; 

b.2.4.3) add a call to initialize the member 
5 wherein the member will know that 

the class to be included in the 
interface wrapper is the master 
class in all constructors of the 
other class in the interface 
10 wrapper; 

b.2.4.4) add a method to the other class in 
the interface wrapper to retrieve 
the member by a type name of the 
other class; 

15 b.3) else 

< 

b.3.1) add a member for the master class to the class 
to be included in the interface wrapper; 

b.3. 2) add a method to the class to be included in 
the interface wrapper to allow the member to 
20 be initialized to point to the master class; 

b.3. 3) add a method to the class to be included in 

the interface wrapper to retrieve the member; 

c) for each attribute in the class to be included in the 
interface wrapper 



25 



c.l) add code from the computer-readable mapping related 
to the attribute to the class to be included in the 
interface wrapper; 
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d) for each method in the class to be included in the 
interface wrapper 

d.l) add code from the computer- readable mapping related 
to the method to the class to be included in the 
5 interface wrapper. 

14. A computer- readable medium containing instructions 

for automatically generating an interface wrapper to 
facilitate migration of a software application from a first 
interface to a second interface, wherein, given a computer- 
10 readable mapping from the first interface to the second 
interface, the instructions comprise: 

a) for each class in the first interface 

a.l) from all classes to be included in the interface 
wrapper mapped from the class in the first 
15 interface, select a master class to hold handles to 

all other classes in the interface wrapper mapped 
from the class in the first interface; 

b) for each class to be included in the interface wrapper as 
set out in the computer-readable mapping 

20 b.l) if the class to be included in the interface wrapper 

is the master class, initialize all the handles in 
the master class; 

b.2) for each attribute in the class to be included in 
the interface wrapper 



25 



b.2.1) add code from the computer-readable mapping 
related to the attribute to the class to be 
included in the interface wrapper; 
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b-3) for each method in the class to h e • -, 

interfaf , 0 383 t0 be ^eluded in the 

incertace wrapper 

b.3.1) add code from t-v,^ 

rel " computer-readable mapping 

related to the method to the class to be 
included in the interface wrapper. 

15 - A computer-readable medium contain^ 

for automatically generate ■ C ° ntainin 9 instructions 

facilitate • 9Sneratln 9 « interface wrapper to 

facilitate nugration of a software application f 
interface to * ^ • application from a first 

ace to a second interface, wherein, given a o 
readable mapping f rom the firsfc 91Ven a com Puter- 

interface the i , interface to the second 

rrace, the instructions comprise: 

-for each class to be included in the interface 

« out in the computer-readable mapping ^ " 

*> -fine the class to be included in the interface wrapper 

b) for each class from the fi rst in ^ f 

class + n K • interface mapped to the 

class to be included in the interface wrapper as H , 
xn the computer readable mapping 

b.D if the class from the f irst interfa _ . 

to hh, i interface is mapped only 

t° the class to be included in the lnterface 
wrapper 

K.I.D add a mem ber for the class fron, the first 

interface to the class to be included i„ the 
interface wrapper; 

b.1.2) add construction of 

uon 01 the member to all 

constructors in the H aof , v. 

. , . hS Class to ^ included in 

the interface wrapper; 
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b.2) else if the class to be included in the interface 

wrapper is the first of all classes in the interface 
wrapper mapped from the class from the first 
interface as set out in the computer- readable 
5 mapping 

b.2.1) designate the class to be included in the 

interface wrapper as a master class to hold 
handles to all other classes in the interface 
wrapper mapped from the class in the first 
10 interface; 

b.2. 2) add a member for the class from the first 

interface to the class to be included in the 
interface wrapper; 

b.2. 3) add construction of the member to all 
15 constructors in the class to be included in 

the interface wrapper; 

b.2. 4) for each other class in the interface wrapper 
mapped from the class from the first 
interface 

20 b.2. 4.1) add a member for the other class in 

the interface wrapper to the master 
class; 

b.2. 4. 2) add construction of the other class 

in the interface wrapper to all 
2 5 constructors in the master class; 

b.2. 4. 3) add a call to initialize the member 
wherein the member will know that 
the class to be included in the 
interface wrapper is the master 
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class in all constructors of the 
other class in the interface 
wrapper; 

b.2.4.4) add a method to the other class in 
the interface wrapper to retrieve 
the member by a type name of the 
other class; 



b. 3) else 



b.3.1) add a member for the master class to the class 
10 to be included in the interface wrapper; 

b.3.2) add a method to the class to be included in 
the interface wrapper to allow the member to 
be initialized to point to the master class; 

b.3.3) add a method to the class to be included in 
15 the interface wrapper to retrieve the member; 

c) for each attribute in the class to be included in the 
interface wrapper 

c.l) add code from the computer- readable mapping related 
to the attribute to the class to be included in the 
20 interface wrapper; 

d) for each method in the class to be included in the 
interface wrapper 



25 



d.l) add code from the computer- readable mapping related 
to the method to the class to be included in the 
interface wrapper. 



